home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / graphics / g-dec / pbm / pnmtoljpg.txt < prev    next >
Text File  |  1999-05-14  |  3KB  |  133 lines

  1.  
  2.  
  3.  
  4. PNMTOLJPG(1)                         PNMTOLJPG(1)
  5.  
  6.  
  7. NAME
  8.        pnmtoljpg - compress a Portable Pixmap or Portable Graymap
  9.        image file to a lossless JPEG file
  10.  
  11. SYNOPSIS
  12.        pnmtoljpg [ -d ] [ -h ] [ -p# ] [ -r# ] [ -s{1..7} ] [  -v
  13.        ] [ filename ...     ]
  14.  
  15.  
  16. DESCRIPTION
  17.        pnmtoljpg  compresses  a     PPM  (Portable     Pixmap) or a PGM
  18.        (Portable Graymap) image, and  produces    a  lossless  JPEG
  19.        (LJPG) file. If no files are specified, the standard input
  20.        is compressed to the standard output.
  21.  
  22. OPTIONS
  23.        -d     Use default Huffman table.  If  this  flag  is  not
  24.           specified, pnmtoljpg will generate an optimal Huff-
  25.           man table.
  26.  
  27.        -h --help
  28.           Display a help screen and quit.
  29.  
  30.        -p#    The #, an integer less than sample precision  bits,
  31.           is the point tranform parameter.
  32.  
  33.        -r#    Restart at every # row(s).
  34.  
  35.        -s{1..7}
  36.           Supply  a     prediction  selection    value  (PSV) set,
  37.           {1..7}. The pnmtoljpg tries all PSVs in the set and
  38.           select  the best one. A PSV is an integer between 1
  39.           and 7 inclusively. If a "-s" flag is not    provided,
  40.           pnmtoljpg will try all seven PSVs.
  41.  
  42.        -v verbose
  43.           Display data about image format, image size, sample
  44.           precision,  total     bytes    category  symbols,  total
  45.           bytes  of     additional  symbols,  original     and com-
  46.           pressed file size, and compress ratio.
  47.  
  48. EXAMPLES
  49.        This example compresses a PPM file  foo.ppm  with  optimal
  50.        Huffman    table  and  the     default  PSV  set. The output is
  51.        foo.ljpg.
  52.  
  53.           pnmtoljpg foo.ppm foo.ljpg
  54.  
  55.        Next example compresses a PGM file  foo.pgm  with  default
  56.        Huffman    table and PSV 4. The output is saved as foo.ljpg.
  57.  
  58.           pnmtoljpg -d -s4 < foo.ppm > foo.ljpg
  59.  
  60.        The last     example  compresses  a     PPM  file  foo.ppm  with
  61.  
  62.  
  63.  
  64.                14 June 1994                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PNMTOLJPG(1)                         PNMTOLJPG(1)
  71.  
  72.  
  73.        optimal    Huffman     table    and  a PSV set {246}. The verbose
  74.        flag is on, and the output is saved as foo.ljpg.
  75.  
  76.           pnmtoljpg -v -s246 foo.ppm > foo.ljpg
  77.  
  78. SEE ALSO
  79.        ljpgtopnm(1), ppm(5), pgm(5)
  80.        Wallace, Gregory K.  "The JPEG Still  Picture  Compression
  81.        Standard", Communications of the ACM, April 1991 (vol. 34,
  82.        no. 4), pp. 30-44.
  83.  
  84. AUTHOR
  85.        Kongji Huang and Brian Smith
  86.  
  87. BUGS
  88.        Arithmetic coding and multiple scans are not supported.
  89.  
  90.        Comments in PPM/PGM files  are  not  stored  in    the  LJPG
  91.        files.
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                14 June 1994                2
  131.  
  132.  
  133.